home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / hs112d2.zip / HSLINK.DOC < prev    next >
Text File  |  1992-05-13  |  100KB  |  2,539 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                 ▒▒▒▒▄ ▒▒▒▒▄   ▒▒▒▒▒▒▒▒▄
  8.                  ▒▒█▀  ▒▒█▀   ▒▒█▀▀▀▒▒█                                 HS/Link
  9.                  ▒▒█   ▒▒█    ▒▒█    ▀▀
  10.                  ▒▒▒▒▒▒▒▒█    ▒▒▒▒▒▒▒▒▄                         High Speed Link
  11.                  ▒▒█▀▀▀▒▒█      ▀▀▀▀▒▒█
  12.                  ▒▒█   ▒▒█    ▒▒▄   ▒▒█                  File Transfer Protocol
  13.                 ▒▒▒▒█ ▒▒▒▒█   ▒▒▒▒▒▒▒▒█
  14.                  ▀▀▀▀  ▀▀▀▀    ▀▀▀▀▀▀▀▀
  15.  
  16.  
  17.                                        HS/Link
  18.  
  19.                                      Version 1.1
  20.  
  21.                        Copyright (C) 1991, 1992 Samuel H. Smith
  22.                             All Rights Reserved, Worldwide
  23.  
  24.  
  25.                               PLEASE REFER TO HSLINK.NEW
  26.                         FOR DETAILS OF RECENT PROGRAM CHANGES!
  27.  
  28.  
  29.       HS/Link is a high speed, full streaming, bidirectional, batch file
  30.       transfer protocol with advanced Full-Streaming-Error-Correction.  Each
  31.       side of the link is allowed to provide a list of files to be sent.  Files
  32.       will be sent in BOTH directions until both sides of the link are
  33.       satisfied.
  34.  
  35.       HS/Link is not just another bidirectional protocol, it is also a very
  36.       fast protocol for normal downloading and uploading, incorporating some
  37.       new ideas (such as Full-Streaming-Error-Correction and Dynamic-Code-
  38.       Substitution) to make things happen a bit faster and with greater
  39.       reliability.
  40.  
  41.       This program is not free!  You are hereby licensed to use this program
  42.       for a trial period of 30 days free of charge.  If, after 30 days, you
  43.       decide that you would like to continue using HSLINK, you must complete
  44.       the registration form (REGISTER.FRM) and return it to the author with the
  45.       required registration fee enclosed.
  46.  
  47.       Registration removes the "UNREGISTERED" and "PLEASE REGISTER" messages,
  48.       as well as all time delays.  Registered copies broadcast their
  49.       registration number to the remote unit.
  50.  
  51.       Please feel free to distribute HSLINK to your friends and local BBSes as
  52.       long as all of the files in this archive are included and unmodified.
  53.  
  54.       See the LICENSE AND REGISTRATION section of this document for more
  55.       details.
  56.  
  57.  
  58.  
  59.  
  60.       HS/Link 1.1 User Documentation                                     - 1 - 
  61.  
  62.  
  63.  
  64.  
  65.                                   Table of Contents
  66.           _________________________________________________________________
  67.  
  68.       Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  69.  
  70.       Full Screen Status Display  . . . . . . . . . . . . . . . . . . . . .   5
  71.  
  72.       Command Line Format . . . . . . . . . . . . . . . . . . . . . . . . .   6
  73.  
  74.       Basic Command Line Options  . . . . . . . . . . . . . . . . . . . . .   6
  75.  
  76.       HS/Link Configuration Manager . . . . . . . . . . . . . . . . . . . .   8
  77.  
  78.       Advanced Command Line Options . . . . . . . . . . . . . . . . . . .    14
  79.  
  80.       Command Line Examples . . . . . . . . . . . . . . . . . . . . . . .    20
  81.  
  82.       Calling HS/Link from COMM programs  . . . . . . . . . . . . . . . .    21
  83.  
  84.       Calling HS/Link from BBS programs . . . . . . . . . . . . . . . . .    22
  85.  
  86.       Flow Control  . . . . . . . . . . . . . . . . . . . . . . . . . . .    24
  87.  
  88.       Full Streaming Data Transmission  . . . . . . . . . . . . . . . . .    26
  89.  
  90.       Full Streaming Error Recovery . . . . . . . . . . . . . . . . . . .    27
  91.  
  92.       Dynamic Code Substitution . . . . . . . . . . . . . . . . . . . . .    28
  93.  
  94.       Transmission of Minimal Blocks  . . . . . . . . . . . . . . . . . .    28
  95.  
  96.       DSZLOG Statistic Logging  . . . . . . . . . . . . . . . . . . . . .    29
  97.  
  98.       Network Compatibility . . . . . . . . . . . . . . . . . . . . . . .    30
  99.  
  100.       Auto Downloading  . . . . . . . . . . . . . . . . . . . . . . . . .    31
  101.  
  102.       Error Messages  . . . . . . . . . . . . . . . . . . . . . . . . . .    32
  103.  
  104.       License and Registration  . . . . . . . . . . . . . . . . . . . . .    38
  105.  
  106.       Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    39
  107.  
  108.       Distributors  . . . . . . . . . . . . . . . . . . . . . . . . . . .    40
  109.  
  110.       Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    42
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.       HS/Link 1.1 User Documentation                                     - 2 - 
  120.  
  121.  
  122.  
  123.  
  124.                                      Introduction
  125.           _________________________________________________________________
  126.  
  127.       What is a file transfer protocol?
  128.  
  129.       A file transfer protocol is a means of transferring information from one
  130.       computer to another.  The protocol has the responsibility of protecting
  131.       against errors in transit, and taking measures to correct any errors that
  132.       are detected.  The design and implementation of a protocol can make the
  133.       difference between slow and unreliable communication, and fast and
  134.       trouble free communication.
  135.  
  136.       Not all protocols are created equal.  With today's high speed modems,
  137.       packet switched networks (such as PC Pursuit), and expensive long
  138.       distance charges, users demand more than ever that files get through
  139.       quickly and without corruption.
  140.  
  141.       The HS/Link protocol is the result of years of communication experience,
  142.       and uses some very new and solid technology to see to it that you can
  143.       easily move files as quickly as possible, and with the least amount of
  144.       hassle.
  145.  
  146.       The HSLINK program can be used from the DOS command line, from BATCH
  147.       files, or as an "external protocol" from most modern COMM programs and
  148.       BBS programs.  If your favorite BBS does not yet support the HS/Link
  149.       protocol, please ask your SYSOP to install it.
  150.  
  151.       Recent advances in high speed modem technology have made it possible to
  152.       simultaneously transfer data at high speeds in both directions.  This
  153.       standardized technology is called "V.32"
  154.       or "V.32bis", and is available in many    ┌───────────────────────────┐
  155.       new modems.  Until HS/Link, these         │Bidirectional features that│
  156.       advanced modems were left half idle, due  │really work...             │
  157.       to the single-direction nature of prior   │HS/Link can simultaneously │
  158.       file transfer protocols.  The             │send and receive files!    │
  159.       bidirectional capabilities of HS/Link     └───────────────────────────┘
  160.       take full advantage of these modems,
  161.       cutting online time as much as 50% when equal amounts of data are
  162.       transmitted and received.
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.       HS/Link 1.1 User Documentation                                     - 3 - 
  179.  
  180.  
  181.  
  182.  
  183.                                Summary of Key Features
  184.           _________________________________________________________________
  185.  
  186.       ∙ Speed.
  187.            HS/Link operates at or very near peak efficiency, often reaching 98%
  188.            or more with pre-compressed files and non-buffered modems.  Even
  189.            higher speeds are possible with buffered or error correcting modems. 
  190.            A number of features, such as fast 32 bit CRC protection, Full-
  191.            Streaming-Error-Recovery and Dynamic-Code-Substitution, combine to
  192.            give maximum performance and security.
  193.  
  194.       ∙ Simple interface for beginners.
  195.            In many cases, HS/Link requires only the COM port number and the
  196.            filename to be transmitted.  Configuration files are not required. 
  197.            The program is easily installed in most COMM programs that support
  198.            external protocols.  The HSLINK program has multiple help screens,
  199.            providing a quick reference to the basic and advanced command line
  200.            options, including examples of how the program is used.
  201.  
  202.       ∙ Batch file transfers.
  203.            The protocol can handle any size batch of files, and can take file
  204.            specifications from either the command line or from a listing file.
  205.  
  206.       ∙ Bi-directional options that really work.
  207.            The program can simultaneously upload and download with a single
  208.            host request.  What's even better is how easy it is to use... 
  209.            instead of a complex setup all you do is:
  210.  
  211.              1) Tell the BBS the names of the files you want to download, and
  212.                 then
  213.  
  214.              2) Press PGUP (or whatever your COMM program uses to UPLOAD files)
  215.                 and then tell your COMM program which files to upload
  216.  
  217.            By virtue of the BBS being told that it is sending files and your
  218.            COMM program telling HS/Link that it too is sending files you then
  219.            have a bidirectional transfer.  There's nothing else to set up.  You
  220.            use the familiar BBS interface to request files to download and your
  221.            COMM program's familiar interface to tell it which files to upload. 
  222.            It couldn't get easier!
  223.  
  224.       ∙ Aborted file crash recovery.
  225.            When desired, HS/Link can resume an aborted transfer, verifying all
  226.            existing data blocks to insure the resumed file completely matches
  227.            the file being transmitted.  This function can also update a file
  228.            that has only a small number of changed, added, or deleted blocks.
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.       HS/Link 1.1 User Documentation                                     - 4 - 
  238.  
  239.  
  240.  
  241.  
  242.                               Full Screen Status Display
  243.           _________________________________________________________________
  244.  
  245.       When HS/Link is operating, it produces a full screen status display,
  246.       divided into five windows.  For example:
  247.  
  248.  ╒══════════ HS/Link v1.1 (5/11/92)  Copyright 1992 Samuel H. Smith ══════════╕
  249.  │ [UNREGISTERED] Courtesy of The Tool Shop BBS (818) 891-6780.               │
  250.  │ Command line: -@tolap.cfg test\*.* -s2048 -w12 -a                          │
  251.  └────────────────────────────────────────────────────────────────────────────┘
  252.  ╒═════════ 5 InComing Files, 710782 bytes ═════════╕ ╒══════ Settings ═══════╕
  253.  │ \TMP\VIROSCAN.ZIP (79 blocks, 161003 bytes)      │ │  COM2 open at: 115200 │
  254.  │ File received OK, 2930 cps, 58 seconds.          │ │Remote Serial#: 00001  │
  255.  │ \TMP\PM.ZIP (37 blocks, 73745 bytes)             │ │Remote Version: 1.10   │
  256.  │ Block 14 (28672 bytes) 2622 cps                  │ │        Window: NONE   │
  257.  │ █████████████░░░░░░░░░░░░░░░░░░░░░░ 18 seconds   │ │    Block size: 2048   │
  258.  └──────────────────────────────────────────────────┘ │      XON/XOFF: ON     │
  259.  ╒════════ 9 OutGoing Files, 2297792 bytes ═════════╕ │ CTS handshake: OFF    │
  260.  │ TEST\PHASE1.EXE (179 blocks, 365810 bytes)       │ │ RTS handshake: OFF    │
  261.  │ File sent OK, 5907 cps, 01:01 minutes.           │ │Slow handshake: ON     │
  262.  │ TEST\PHASE2.EXE (204 blocks, 416884 bytes)       │ │        Resume: OFF    │
  263.  │ Block 20 (40960 bytes/w:20) 5570 cps             │ │  Keep partial: ON     │
  264.  │ ███░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 01:08 minutes│ │     Overwrite: ON     │
  265.  └──────────────────────────────────────────────────┘ └─ ^X^X^X^X to abort! ──┘
  266.  ╒═══════════════════════════════ Batch Status ═══════════════════════════════╕
  267.  │ Total 2047451 bytes (of 3008574) in 04:00 minutes, thruput 8509 cps.       │
  268.  │ ██████████████████████████████████░░░░░░░░░░░░░░░░░ 01:53 minutes remaining│
  269.  └───────────────────────── PLEASE REGISTER HS/LINK! ─────────────────────────┘
  270.  
  271.       The first window contains the program identification and copyright.  When
  272.       you register your copy of HSLINK, this window will also show the
  273.       registered serial number.  Some warning messages may also appear in this
  274.       window.
  275.  
  276.       The "Settings" window shows a summary of the various parameters that can
  277.       be altered with command line options.
  278.  
  279.       The "InComing Files" window shows the status of files being received from
  280.       the remote system.
  281.  
  282.       The "OutGoing Files" window shows the status of files being transmitted
  283.       to the remote system.
  284.  
  285.       The "Batch Status" window summarizes overall session progress and
  286.       estimates the time remaining for the selected files.
  287.  
  288.       To stop display bleedthrough under DesqView or DoubleDOS, use the -NV
  289.       option to disable direct video writing.  
  290.  
  291.       If desired, the full screen status display can be turned off.  To do
  292.       this, use the -NF command line option.  When running in -NF mode, a
  293.       simple line-oriented status display will scroll down the screen.  This
  294.       may be desired under some circumstances.
  295.  
  296.       HS/Link 1.1 User Documentation                                     - 5 - 
  297.  
  298.  
  299.  
  300.  
  301.                                  Command Line Format
  302.           _________________________________________________________________
  303.  
  304.       To run the HSLINK program, a command line must be given.  The command
  305.       line has the following format:
  306.  
  307.       HSLINK [options] [SENDFILE] [@DRIVE:\PATH\FILELIST]
  308.  
  309.       SENDFILE  Indicates a list of files to be transmitted to remote computer. 
  310.                 The list may include the DOS wildcard characters '?' and '*'. 
  311.                 Specify ONLY files to be transmitted; received file names are
  312.                 determined automatically.
  313.  
  314.       @FILELIST Transmit list of files contained in FILELIST to remote
  315.                 computer.  This is used when you want to make a long list of
  316.                 files in advance, then transmit them all with a single command. 
  317.                 It is also used by BBS programs to produce long batches of
  318.                 downloads.
  319.  
  320.       ∙    Anything shown in brackets "[]" is optional and may not need to be
  321.            specified for proper operation of HS/Link.
  322.       ∙    The HSLINK command line is NOT case sensitive, and will work when
  323.            typed in upper, lower or mixed case.
  324.       ∙    Please make sure that HSLINK.EXE is in a search PATH directory.
  325.  
  326.                               Basic Command Line Options
  327.           _________________________________________________________________
  328.  
  329.       The most important command line options are -P (set COM port), -U (set
  330.       download file directory), and -HS (enable slow handshake).
  331.  
  332.       -Pport    This option specifies which COM port you are using.
  333.                 Example:  -P2
  334.  
  335.       -Udir     This option controls the destination directory for downloaded
  336.                 files.  Without this option, all download files are placed into
  337.                 the current directory.
  338.                 Example:  -Uc:\bbsfiles
  339.  
  340.       -HS       Handshake Slow (send XOFF and/or lower RTS during disk I/O). 
  341.                 This option may be required if your computer is unable to
  342.                 simultaneously access the disk and the COM port.  If you see
  343.                 frequent CRC error messages, even on clean phone lines, you
  344.                 probably need to include -HS in your command line.
  345.  
  346.       To abort an HS/Link transfer, press Control-X four or more times.
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.       HS/Link 1.1 User Documentation                                     - 6 - 
  356.  
  357.  
  358.  
  359.  
  360.                                  Configuration Files
  361.           _________________________________________________________________
  362.  
  363.       Because of the large number of possible command line options, it is
  364.       possible to store frequently used command options in a configuration
  365.       file.  This eliminates the need to        ┌────────────────────────┐
  366.       repeatedly type the options at a command  │HS/Link does NOT require│
  367.       line.  If you are calling HSLINK from     │configuration files.    │
  368.       multiple batch files, you can also use    └────────────────────────┘
  369.       configuration files to store "common"
  370.       options, that can be changed in one place rather than separately in the
  371.       various batch files.
  372.  
  373.       HSLINK will first search the current for
  374.       the HSLINK.CFG file.  If not found, it    ┌───────────────────────────┐
  375.       will then search the directory where      │For best results, add your │
  376.       HSLINK.EXE is stored, followed by all     │HS/Link or COMM program    │
  377.       directories in the DOS PATH setting. If   │directory to your PATH     │
  378.       the HSLINK.CFG file is found, each file   │statement.                 │
  379.       line is loaded as a command line option.  └───────────────────────────┘
  380.  
  381.  
  382.       If you want to use an alternate configuration file, use the -@fname
  383.       command line option, which will cause 'fname' to be loaded.  For example:
  384.            HSLINK -@C:\WORK\TOLAP.CFG
  385.       will cause HSLINK to use C:\WORK\TOLAP.CFG as the configuration file.
  386.  
  387.  
  388.       If -@fname is not the first command line option, the default HSLINK.CFG
  389.       file will be searched for and loaded before the specified configuration
  390.       file.
  391.  
  392.  
  393.       Use -@ (without a filename) to prevent HSLINK from searching for a
  394.       configuration file, slightly speeding operation on systems that have a
  395.       long search PATH setting in effect.
  396.  
  397.  
  398.       To aid in creation and alteration of
  399.       configuration files, the HS/Link          ┌───────────────────────────┐
  400.       Configuration Manager program, HSCONFIG,  │Use HSCONFIG to create and │
  401.       was written.                              │edit HS/Link option        │
  402.                                                 │(configuration) files.     │
  403.                                                 └───────────────────────────┘
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.       HS/Link 1.1 User Documentation                                     - 7 - 
  415.  
  416.  
  417.  
  418.  
  419.                             HS/Link Configuration Manager
  420.           _________________________________________________________________
  421.  
  422.       HSLINK includes the HS/Link Configuration Manager program, HSCONFIG.EXE. 
  423.       With this program you can easily manipulate most of HS/Link's many
  424.       options.
  425.  
  426.  
  427.       The opening display for HSCONFIG looks like this:
  428.  
  429.  Node-3 C:\HSL >hsconfig
  430.  HS/Link Configuration Manager 1.1 (C)1992 Samuel H. Smith; ALL RIGHTS RESERVED
  431.  
  432.         ┌────────────────── New Configuration ─────────────────────┐
  433.         │                                                          │
  434.         │ The specified configuration file cannot be located.      │
  435.         │                                                          │
  436.         │ This probably indicates that you are creating a new      │
  437.         │ configuration for HS/Link.  All options will be set      │
  438.         │ to default values.                                       │
  439.         │                                                          │
  440.         │ Alternate configuration files can be specified on        │
  441.         │ the command line to HSCONFIG.  The default configuration │
  442.         │ file is HSLINK.CFG, and it may be located either in the  │
  443.         │ current directory, or in any PATH directory.             │
  444.         │                                                          │
  445.         │ Press <ENTER> or <ESC> to continue.                      │
  446.         │                                                          │
  447.         │  Index  <ESC>                                            │
  448.         └──────────────────────────────────────────────────────────┘
  449.  
  450.  Can't find: C:\UTIL\HSLINK.CFG
  451.  
  452.  
  453.       HSCONFIG can be used to edit any configuration file, but the default is
  454.       to edit HSLINK.CFG in the current directory, or the same directory in
  455.       which HSLINK.EXE is found.  If you want to edit some other configuration
  456.       file, you must specify the filename on the HSCONFIG command line.  For
  457.       example:
  458.  
  459.            HSCONFIG TOLAP.CFG
  460.  
  461.       will create or edit TOLAP.CFG, which can later be used by HSLINK with a
  462.       command line like this:
  463.  
  464.            HSLINK -@TOLAP.CFG
  465.  
  466.       When no configuration filename is specified, and the default
  467.       configuration file HSLINK.CFG cannot be located, it will automatically be
  468.       created in the same directory that HSLINK.EXE is found in.  If you wish
  469.       to create the configuration file in a different directory, you must
  470.       explicitly specify the directory/filename to be used on the HSCONFIG
  471.       command line.
  472.  
  473.       HS/Link 1.1 User Documentation                                     - 8 - 
  474.  
  475.  
  476.  
  477.  
  478.       The primary screen in HSCONFIG is the "Basic Settings" screen, which
  479.       controls the most important settings for HS/Link operation.  The other
  480.       screens contain advanced settings that need not be changed until you
  481.       become more familiar with the program and begin to explore the advanced
  482.       capabilities.
  483.  
  484.   ╒════════════════════════ HS/Link: Basic Settings ════════════════════════╕
  485.   │                                                                         │
  486.   │    These are the most important settings for proper HS/Link operation   │
  487.   │                                                                         │
  488.   │  COM port number (1-8) . . . . . . . . . . . 1                          │
  489.   │                                                                         │
  490.   │  Directory for downloaded files. . . . . . . __________________________ │
  491.   │                                                                         │
  492.   │  Use "SLOW HANDSHAKE" during disk I/O. . . . N                          │
  493.   │                                                                         │
  494.   ╘═════════════════════════════════════════════════════════════════════════╛
  495.  
  496.              ┌──────────────────── Welcome! ───────────────────────┐
  497.              │ Welcome to the HS/Link Configuration Manager.       │
  498.              │ The easy way to handle HS/Link configuration files. │
  499.              │                                                     │
  500.              │ Use the arrow keys to select entries on this page.  │
  501.              │ Use the PgUp/PgDn keys to change pages.             │
  502.              │ Press ESC to save changes when you are finished.    │
  503.              │                                                     │
  504.              │ Use the F1 key to get HELP at any prompt.           │
  505.              └─────────────────────────────────────────────────────┘
  506.  
  507.  PgDn [next page]     PgUp [prior page]             F1 [help]     ESC [exit]
  508.  
  509.  
  510.       The HSCONFIG program contains context sensitive pop-up help for each and
  511.       every input prompt.  Simply press the F1 key to get an explanation of the
  512.       current entry.  For example:
  513.  
  514.         ┌───────────────────────────── -U ────────────────────────────────┐
  515.         │ -Udir  > Download directory.                                    │
  516.         │                                                                 │
  517.         │ This option controls the destination directory for downloaded   │
  518.         │ files.  Without this option, all download files are placed into │
  519.         │ the current directory.                                          │
  520.         │                                                                 │
  521.         │  Index  <ESC>                                                   │
  522.         └─────────────────────────────────────────────────────────────────┘
  523.  
  524.       When in the online help system, press the SPACE and BACKSPACE keys to
  525.       select from the topics available at the bottom of the window, and press
  526.       ENTER to select a topic.  Press ESCAPE to return to the prior screen.
  527.  
  528.  
  529.  
  530.  
  531.  
  532.       HS/Link 1.1 User Documentation                                     - 9 - 
  533.  
  534.  
  535.  
  536.  
  537.       The "Advanced COM Settings" screen determines the settings of many
  538.       communications related options.  See the following section, "Advanced
  539.       Options" for a description of each of these options.
  540.  
  541.  ╒════════════════════ HS/Link: Advanced COM Settings ═══════════════════OVR═╕
  542.  │                                                                           │
  543.  │         These settings control advanced communication features            │
  544.  │                                                                           │
  545.  │ Non-Standard COM base (in HEX, 0 = standard COM port) . . . . . . 0000    │
  546.  │                                                                           │
  547.  │ Non-Standard COM IRQ (1-15, 0 = standard COM port). . . . . . . . 0_      │
  548.  │                                                                           │
  549.  │ COM port open speed (300-115200, 0 = automatic) . . . . . . . . . 0_____  │
  550.  │                                                                           │
  551.  │ Effective modem-to-modem speed (0 = same as open speed) . . . . . 0_____  │
  552.  │                                                                           │
  553.  │ Enable CTS hardware handshake . . . . . . . . . . . . . . . . . . Y       │
  554.  │                                                                           │
  555.  │ Enable RTS hardware handshake . . . . . . . . . . . . . . . . . . Y       │
  556.  │                                                                           │
  557.  │ Enable XON/XOFF software handshake. . . . . . . . . . . . . . . . Y       │
  558.  │                                                                           │
  559.  │ Enable Carrier Detect checking. . . . . . . . . . . . . . . . . . Y       │
  560.  │                                                                           │
  561.  │ Preserve original time/date stamp on received files . . . . . . . Y       │
  562.  │                                                                           │
  563.  ╘═══════════════════════════════════════════════════════════════════════════╛
  564.  
  565.   PgDn [next page]     PgUp [prior page]             F1 [help]     ESC [exit]
  566.  
  567.  
  568.       This screen manipulates the following options:
  569.  
  570.       -PB (define non-standard COM base address), 
  571.       -PI (define non-standard COM irq), 
  572.       -B (COM port open speed), 
  573.       -E (effective modem to modem speed), 
  574.       -HC (disable CTS handshake), 
  575.       -HR (disable RTS handshake), 
  576.       -HX (disable XON/XOFF handshake), 
  577.       -C (disable carrier detect monitoring) and 
  578.       -NT (disable preservation of original date/time stamp) 
  579.  
  580.       These options will be described in detail in the next section.
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.       HS/Link 1.1 User Documentation                                    - 10 - 
  592.  
  593.  
  594.  
  595.  
  596.       The "Advanced Optional Features (part 1)" screen controls many advanced
  597.       protocol features.  See the following section, "Advanced Options" for a
  598.       description of each of these options.
  599.  
  600.  ╒═════════════ HS/Link: Advanced Optional Features (part 1) ════════════OVR═╕
  601.  │                                                                           │
  602.  │            These settings control various optional features               │
  603.  │                                                                           │
  604.  │ Attempt to Resume aborted transfers . . . . . . . . . . . . . . . N       │
  605.  │                                                                           │
  606.  │ Keep partial files from aborted transfers . . . . . . . . . . . . N       │
  607.  │                                                                           │
  608.  │ Allow received files to overwrite/modify existing files . . . . . N       │
  609.  │                                                                           │
  610.  │ Enable file read/write buffering. . . . . . . . . . . . . . . . . Y       │
  611.  │                                                                           │
  612.  │ Enable "Dynamic-Code-Substitution" logic. . . . . . . . . . . . . Y       │
  613.  │                                                                           │
  614.  │ Size of transmitted data blocks (64-4096 bytes/block) . . . . . . 1024    │
  615.  │                                                                           │
  616.  │ Number of blocks in transit before ACK is required (0-1000) . . . 8___    │
  617.  │                                                                           │
  618.  │ Disable transmission of ACK for each block received . . . . . . . N       │
  619.  │                                                                           │
  620.  │ Force remote unit to use local option settings. . . . . . . . . . N       │
  621.  │                                                                           │
  622.  ╘═══════════════════════════════════════════════════════════════════════════╛
  623.  
  624.    PgDn [next page]     PgUp [prior page]             F1 [help]     ESC [exit]
  625.  
  626.  
  627.       This screen manipulates the following options:
  628.  
  629.       -R (resume aborted transfers), 
  630.       -K (keep partial files), 
  631.       -O (allow overwrite of receive files), 
  632.       -NB (disable file buffering), 
  633.       -NC (disable dynamic code substitution), 
  634.       -S (data block size), 
  635.       -W (acknowledge window size), 
  636.       -A (disable receive acknowledge) and 
  637.       -! (force remote to use local options) 
  638.  
  639.       These options will be described in detail in the next section.
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.       HS/Link 1.1 User Documentation                                    - 11 - 
  651.  
  652.  
  653.  
  654.  
  655.       The "Advanced Optional Features (part 2)" screen controls more advanced
  656.       protocol features.  See the following section, "Advanced Options" for a
  657.       description of each of these options.
  658.  
  659.  ╒═════════════ HS/Link: Advanced Optional Features (part 2) ════════════OVR═╕
  660.  │                                                                           │
  661.  │              These settings control more optional features                │
  662.  │                                                                           │
  663.  │ Idle method (0=none, 1=bios, 2=desqview, 3=ddos). . . . . . . . . 0       │
  664.  │                                                                           │
  665.  │ Disable NS16550AN buffering logic . . . . . . . . . . . . . . . . N       │
  666.  │                                                                           │
  667.  │ Enable "Minimal-Blocks" logic (requires MNP). . . . . . . . . . . N       │
  668.  │                                                                           │
  669.  │ Incoming file duplication check list. . . . ____________________________  │
  670.  │                                                                           │
  671.  │ DSZLOG status logging file. . . . . . . . . ____________________________  │
  672.  │                                                                           │
  673.  │ Force CTS handshake even when CTS is initially missing. . . . . . N       │
  674.  │                                                                           │
  675.  │                                                                           │
  676.  │                                                                           │
  677.  │                                                                           │
  678.  │                                                                           │
  679.  │                                                                           │
  680.  │                                                                           │
  681.  ╘═══════════════════════════════════════════════════════════════════════════╛
  682.  
  683.   PgDn [next page]     PgUp [prior page]             F1 [help]     ESC [exit]
  684.  
  685.  
  686.       This screen manipulates the following options:
  687.  
  688.       -I (what to do during idle time),
  689.       -N5 (disable hardware buffering if NS16550 is present),
  690.       -NM (enable minimal blocks logic),
  691.       -NO (incoming file duplication checklist),
  692.       -FL (DSZLOG status logging file), and
  693.       -FC (force CTS handshake even when CTS is missing)
  694.  
  695.       These options will be described in detail in the next section.
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.       HS/Link 1.1 User Documentation                                    - 12 - 
  710.  
  711.  
  712.  
  713.  
  714.       The "Screen Settings" screen allows you to control the format of the
  715.       status display screen, the colors to be used, and to enable or disable
  716.       direct-video screen updates.
  717.  
  718.   ╒════════════════════════ HS/Link: Screen Settings ════════════════════OVR═╕
  719.   │                                                                          │
  720.   │            These settings control the screen format and colors           │
  721.   │                                                                          │
  722.   │  Enable Full-Screen status display . . . . . . . . . . . . . . . . Y     │
  723.   │  Enable direct video writing (turn off in DesqView/DoubleDOS/etc). Y     │
  724.   │                                                                          │
  725.   │  Color of BORDER in full screen mode . . . . . . . . . . . . . . . 7__   │
  726.   │  Color of PROMPTS in full screen mode. . . . . . . . . . . . . . . 47_   │
  727.   │  Color of WINDOW TITLE in full screen mode . . . . . . . . . . . . 79_   │
  728.   │  Color of WINDOW CONTENTS in full screen mode. . . . . . . . . . . 31_   │
  729.   │  Color of PROGRESS GRAPHS in full screen mode. . . . . . . . . . . 14_   │
  730.   │                                                                          │
  731.   ╘══════════════════════════════════════════════════════════════════════════╛
  732.       ┌── Color Table ───────────────────────────────────────────────────┐
  733.       │   0   1   2   3   4   5   6   7   8   9  10  11  12  13  14  15  │
  734.       │  16  17  18  19  20  21  22  23  24  25  26  27  28  29  30  31  │
  735.       │  32  33  34  35  36  37  38  39  40  41  42  43  44  45  46  47  │
  736.       │  48  49  50  51  52  53  54  55  56  57  58  59  60  61  62  63  │
  737.       │  64  65  66  67  68  69  70  71  72  73  74  75  76  77  78  79  │
  738.       │  80  81  82  83  84  85  86  87  88  89  90  91  92  93  94  95  │
  739.       │  96  97  98  99 100 101 102 103 104 105 106 107 108 109 110 111  │
  740.       │ 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127  │
  741.       └──────────────────────────────────────────────────────────────────┘
  742.    PgDn [next page]     PgUp [prior page]             F1 [help]     ESC [exit]
  743.  
  744.  
  745.       This screen manipulates the following options:
  746.  
  747.       -NF (disable full screen status display), 
  748.       -NV (disable direct video screen updates), 
  749.       -CB (define border color), 
  750.       -CM (define main/prompt color), 
  751.       -CT (define title color),
  752.       -CW (define window contents color) and
  753.       -CG (define bargraph color)
  754.  
  755.       These options will be described in detail in the next section.
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.       HS/Link 1.1 User Documentation                                    - 13 - 
  769.  
  770.  
  771.  
  772.  
  773.                             Advanced Command Line Options
  774.           _________________________________________________________________
  775.  
  776.       The HS/Link protocol program has a number of command line options, most
  777.       of which are rarely needed, or which are provided for advanced users to
  778.       obtain maximum performance and flexibility.
  779.  
  780.       -@fname
  781.            Uses fname as an alternate configuration file.  Each line in the
  782.            specified file may contain a single command line option.  The
  783.            default is to search PATH directories for HSLINK.CFG.
  784.  
  785.       -!
  786.            Take priority.  Locally specified -A, -HX, -S, and -W settings will
  787.            be used by the remote system.
  788.  
  789.       -A
  790.            Disable transmission of ACK codes after each block.  This may
  791.            improve transfer speeds under some conditions.
  792.  
  793.       -Bbaud
  794.            COM port opening baud rate 300-      ┌───────────────────────────┐
  795.            115200 (default=current port OPEN    │Don't use the -B option if │
  796.            speed).                              │you don't need to!  In most│
  797.            This option controls the speed at    │cases HS/Link is able to   │
  798.            which the COM port will be opened.   │automatically determine the│
  799.                                                 │proper port opening speed. │
  800.            Normally, the COM port speed can be  └───────────────────────────┘
  801.            determined from hardware and need
  802.            not be specified.
  803.  
  804.       -C
  805.            Disable carrier detect checking.  Use this option when directly
  806.            connecting two machines via a null modem cable.
  807.  
  808.       -CBcolor
  809.            Defines the border color in full screen mode.
  810.  
  811.       -CMcolor
  812.            Defines the main screen color in full screen mode.
  813.  
  814.       -CTcolor
  815.            Defines the window title color in full screen mode.
  816.  
  817.       -CWcolor
  818.            Defines the window contents color in full screen mode.
  819.  
  820.       -CGcolor
  821.            Defines the file and batch progress bargraph color in full screen
  822.            mode.
  823.  
  824.  
  825.  
  826.  
  827.       HS/Link 1.1 User Documentation                                    - 14 - 
  828.  
  829.  
  830.  
  831.  
  832.       -Ebaud
  833.            Effective modem-to-modem baud rate.
  834.            This is used to estimate transfer times, and is included in the
  835.            DSZLOG output.  (default=current -B setting)
  836.  
  837.       -FC
  838.            Force CTS hardware handshake.
  839.            This option prevents HSLINK from automatically disabling CTS
  840.            hardware handshake if CTS is not active initially.
  841.  
  842.       -HC
  843.            Disables CTS hardware handshake.
  844.            CTS transmitter handshake is automatically enabled, but may conflict
  845.            with some unusual modem cables or serial ports.  If the CTS signal
  846.            is not active when HSLINK loads, it will automatically disable CTS
  847.            handshake for you.  Use the -HC command to manually disable CTS
  848.            handshake.
  849.  
  850.       -HR
  851.            Disables RTS hardware handshake.
  852.            RTS receiver handshake is used when the slow-handshake option is
  853.            selected.  This form of handshake causes the RTS line to the modem
  854.            to be lowered whenever the disk is being accessed.  Some unusual
  855.            modem or cable arrangements may not tolerate the RTS line being
  856.            lowered.  In this case, the RTS handshake can be disabled with the -
  857.            HR option.
  858.  
  859.       -HS
  860.            Handshake Slow (send XOFF and/or lower RTS during disk I/O).
  861.            The slow handshake option is available for systems with slow disk
  862.            access.  Use this if you get frequent CRC errors or COM Overrun
  863.            errors on otherwise clean lines.  The slow handshake option causes
  864.            XOFF to be sent and/or RTS to be lowered during any disk activity. 
  865.            Even when -HS is active, the HS/Link protocol should transfer data
  866.            very nearly as fast as the slowest part of the link allows.
  867.  
  868.       -HX
  869.            Disable XON/XOFF handshake.
  870.            XON/XOFF handshake is a software handshake scheme that should work
  871.            well on all combinations of modems and networks, and is enabled by
  872.            default.  If you prefer not to use XON/XOFF handshake, or you find
  873.            that it is not required for error-free transfer, you can disable it
  874.            with the -HX option.
  875.  
  876.            Note that both the sender and the receiver must simultaneously
  877.            disable XON/XOFF handshake, otherwise it will remain in effect.
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.       HS/Link 1.1 User Documentation                                    - 15 - 
  887.  
  888.  
  889.  
  890.  
  891.       -Iidle
  892.            This option controls how idle time is given up under multitasking
  893.            environments.  The possible values are:
  894.                 -I0  Default, do not give up idle time
  895.                 -I1  Spend idle time checking keyboard status
  896.                 -I2  Give up idle time under DesqView
  897.                 -I3  Give up idle time under DoubleDOS
  898.            Some network server software, such as LanTastic, performs best when
  899.            the -I1 option is used.
  900.  
  901.       -K
  902.            Keep partial files from aborted transfers.
  903.  
  904.       -LFlogfile
  905.            Specify status log file.
  906.            This option allows you to override the DSZLOG environment variable
  907.            to specify the file to be used for status logging. Omit this option,
  908.            or leave blank to control this function through the DSZLOG
  909.            environment variable.
  910.  
  911.       -N5
  912.            This option causes HS/Link to disable NS16550 buffering logic.  This
  913.            option may be needed with some early versions, or incorrect clone
  914.            versions of the NS16550 chip, which do not properly perform
  915.            buffering.
  916.  
  917.       -NB
  918.            Disable buffering of receive and transmit files.  The default is to
  919.            divide approximately 24k of memory between InComing and OutGoing
  920.            files.
  921.  
  922.       -NC
  923.            Disable Dynamic Code Substitution logic.
  924.            Certain byte codes cannot be transmitted directly over the COM link.
  925.            For instance, the codes for Control-X, Control-S and Control-Q must
  926.            be "escaped" to prevent a conflict with flow or program control.
  927.  
  928.            The HS/Link protocol uses a new Dynamic Code Substitution system to
  929.            drastically reduce the number protocol overhead and "escape" codes
  930.            needed to transmit certain data streams.
  931.  
  932.            Highly compressed data files (such as ZIP and GIF files) benefit the
  933.            most, since they often have many byte codes that cannot be
  934.            transmitted directly over the COM link.
  935.  
  936.       -NF
  937.            Disable Full screen mode.  The standard status display takes over
  938.            the full screen (except the top 2 lines, which may contain a BBS
  939.            status line).  
  940.  
  941.            This option bypasses the full screen display and causes a line-
  942.            oriented output to be used.  Use this option if your environment's
  943.            screen management does not allow a full-screen display.
  944.  
  945.       HS/Link 1.1 User Documentation                                    - 16 - 
  946.  
  947.  
  948.  
  949.  
  950.       -NM
  951.            Enable Minimal Blocks logic.  Use    ┌─────────────────────────┐
  952.            with caution.  This option is        │HS/Link's Full Screen    │
  953.            recommended for use only on error-   │status display does not  │
  954.            corrected links, such as with MNP    │alter the first 2 display│
  955.            or V.42 connections.                 │lines.  The last display │
  956.                                                 │line is also left alone. │
  957.       -NT                                       └─────────────────────────┘
  958.            Stamp current file time.   This
  959.            option stamps the current time/date on received files, instead of
  960.            retaining the original file time/date.
  961.  
  962.       -NOdirlist
  963.            Incoming file duplication checklist.
  964.  
  965.            This option allows you to check incoming files for duplication in a
  966.            list of directories.  This feature prevents incoming files from
  967.            duplicating files in directories other than the current -U setting.
  968.  
  969.            The dirlist is a text file which contains one filename or directory
  970.            specification per line.  See MKDLIST documentation for special
  971.            instructions to speed CD-ROM duplication checking.
  972.  
  973.       -NU
  974.            Block uploads.   This option is used by BBS programs that cannot
  975.            (yet) cope with bidirectional uploads.  It is used in place of the -
  976.            U option on the 'download' command line, and has the effect of
  977.            blocking any simultaneous upload requests from a user.
  978.  
  979.       -NV
  980.            Disable direct Video for             ┌─────────────────────────┐
  981.            DesqView/DoubleDOS/etc.  Use this    │You may need to use -NV  │
  982.            option if you experience "bleeding"  │to stop display bleeding.│
  983.            of the status display from one       └─────────────────────────┘  
  984.            partition to another.  
  985.  
  986.       -O
  987.            Allow receive files to overwrite existing files.
  988.  
  989.       -Pport
  990.            Use COM port 1-8 (default=1).   Standard COM port definitions:
  991.                 Channel   I/O Port  Interrupt
  992.                  COM1      0x3F8     4
  993.                  COM2      0x2F8     3
  994.                  COM3      0x3E8     4
  995.                  COM4      0x2E8     3
  996.                  COM5      undefined
  997.                  COM6      undefined
  998.                  COM7      0x2E8     5
  999.                  COM8      0x3E8     5
  1000.            Use -PB and -PI instead of -P to define a non-standard COM port.
  1001.  
  1002.  
  1003.  
  1004.       HS/Link 1.1 User Documentation                                    - 17 - 
  1005.  
  1006.  
  1007.  
  1008.  
  1009.       -PBbase
  1010.            Set non-standard COM port base address.  Base addresses may be
  1011.            specified in either decimal or hex.  Hex addresses must begin with $
  1012.            or 0x.  For example, -PB1000, -PB$3E8 and -PB0x3E8 all specify the
  1013.            same port base address.
  1014.  
  1015.       -PIirq
  1016.            Set non-standard COM port IRQ level to 1-15.  This option must be
  1017.            used when -PB is used.  IRQ levels 8-15 are supported only on AT
  1018.            class machines with cascaded interrupt controllers.
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.       HS/Link 1.1 User Documentation                                    - 18 - 
  1064.  
  1065.  
  1066.  
  1067.  
  1068.       -R
  1069.            Resume aborted transfer.  The        ┌────────────────────────┐
  1070.            receiver and transmitter will        │Use -R -K -O if you want│
  1071.            verify the contents of an existing   │Download Crash Recovery │
  1072.            file, and will begin transmission    └────────────────────────┘
  1073.            at the first block that does not
  1074.            match.  This provides a reliable means of restarting an aborted
  1075.            transfer, or of updating a modified file.  You must also use -O to
  1076.            recover aborted downloads.
  1077.  
  1078.       -Ssize
  1079.            Sets transmit block size 2-4096 (default=1024) Larger block sizes
  1080.            may result in higher transfer speeds under clean line conditions.
  1081.  
  1082.       -Udir
  1083.            Destination directory for received files (default=current directory)
  1084.  
  1085.       -Wwindow
  1086.            Number of blocks allowed without     ┌──────────────────────┐
  1087.            ACK 1-1000 (default=8)               │Use -W4 -S512 -! with │
  1088.            Use -A to establish an "infinite"    │PC-Pursuit            │
  1089.            window (i.e. no ACK required at      └──────────────────────┘
  1090.            all).
  1091.  
  1092.            The "ACK window" is the number of blocks that will be sent to the
  1093.            modem before an ACKnowledge code is required.  If the specified
  1094.            number of blocks have been sent and no ACK has yet been received,
  1095.            output will be suspended until the ACK is received or the link times
  1096.            out.  This provides a form of software flow control that works well
  1097.            when parts of the link are very slow compared to other parts, such
  1098.            as when PC Pursuit is in use.
  1099.  
  1100.            The /w:XXX value displayed in the InComing Files window reports the
  1101.            actual number of blocks that are being transmitted prior to
  1102.            acknowledge.  Setting the -W value higher than the highest /w:XXX
  1103.            value observed will have no further effect on transfer thruput.
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.       HS/Link 1.1 User Documentation                                    - 19 - 
  1123.  
  1124.  
  1125.  
  1126.  
  1127.                                 Command Line Examples
  1128.           _________________________________________________________________
  1129.  
  1130.       HSLINK -?
  1131.            Display a summary of HS/Link command line formats.
  1132.  
  1133.       HSLINK -P1
  1134.            Download from a BBS using HS/Link.  COM1 will be used at the current
  1135.            port speed.  Received files will go into the current directory.
  1136.  
  1137.       HSLINK -P2 -Uc:\bbsfiles -K
  1138.            Download from a BBS using HS/Link.  COM2 will be used at the current
  1139.            port speed.  Received files will go into the c:\bbsfiles directory. 
  1140.            Partial files from aborted transfers will be kept.
  1141.  
  1142.       HSLINK -P1 -Uc:\bbsfiles -R -K -O
  1143.            Continue an aborted download from a BBS using HS/Link.  COM1 will be
  1144.            used at the current port speed.  Received files will go into the
  1145.            c:\bbsfiles directory.
  1146.  
  1147.       HSLINK -Uc:\bbsfiles c:\uploads\*.zip
  1148.            Download from a BBS using HS/Link.  COM1 will be used at the current
  1149.            port speed.  Received files will go into the c:\bbsfiles directory. 
  1150.            Simultaneously upload all *.ZIP files in the c:\uploads
  1151.            subdirectory.
  1152.  
  1153.       HSLINK file1.zip file2.zip file3.zip
  1154.            Upload to a BBS using HS/Link.  COM1 will be used at the current
  1155.            port speed.  Simultaneously downloads selected files from the BBS
  1156.            into the current directory.
  1157.  
  1158.       HSLINK -b115200 -p2 -c -hs -hc -a file1.zip file2.zip
  1159.            Communicate files with a laptop computer using port COM2 and a three
  1160.            wire null modem cable.
  1161.  
  1162.       HSLINK -w4 -s512 -! -uc:\download
  1163.            Download files through PC-Pursuit using a window of 4 blocks and a
  1164.            block size of 512 bytes.  This setting stops most errors when PC-
  1165.            Pursuit is heavily loaded.
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.       HS/Link 1.1 User Documentation                                    - 20 - 
  1182.  
  1183.  
  1184.  
  1185.  
  1186.                           Calling HS/Link from COMM programs
  1187.           _________________________________________________________________
  1188.  
  1189.       The HS/Link protocol can be easily installed in most modern COMM
  1190.       programs.  Specific instructions have been prepared for many popular COMM
  1191.       programs, and are available in separate files for download.
  1192.  
  1193.            Communication program         Instructions posted in
  1194.            _____________________         _______________________
  1195.  
  1196.            BOYAN 4.01                    HS-BOY40.ZIP
  1197.            BOYAN 5.0                     HS-BOY50.ZIP
  1198.            {COMMO}                       HS-COMMO.ZIP
  1199.            GT POWER 15.50                HS-GT15.ZIP
  1200.            ProComm Plus and
  1201.            ProComm Plus Test Drive       HS-PCPTD.ZIP
  1202.            QMODEM 4.3                    HS-QMOD.ZIP
  1203.            ROBO COMM 3.1                 HS-RC31.ZIP
  1204.            TELEMATE 2.1                  HS-TMATE.ZIP
  1205.            TELIX 3.1                     HS-TELIX.ZIP
  1206.  
  1207.  
  1208.       Installation instructions for new COMM
  1209.       programs are being written all the time,  ┌───────────────────────────┐
  1210.       so check with your local bulletin board   │Check The Tool Shop BBS for│
  1211.       or on the Tool Shop for instructions for  │the latest version of      │
  1212.       additional communication programs.        │HS-INST.ZIP.  New COMM and │
  1213.                                                 │BBS programs are frequently│
  1214.                                                 │added to the library of    │
  1215.                                                 │install instructions       │
  1216.                                                 │available.                 │
  1217.                                                 └───────────────────────────┘
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.       HS/Link 1.1 User Documentation                                    - 21 - 
  1241.  
  1242.  
  1243.  
  1244.  
  1245.                           Calling HS/Link from BBS programs
  1246.           _________________________________________________________________
  1247.  
  1248.       The HS/Link protocol can easily be installed in most modern BBS programs
  1249.       as an external protocol.  Specific instructions have been prepared for
  1250.       many popular BBS programs, and are available in separate files for
  1251.       download.
  1252.  
  1253.            BBS program                        Instructions posted in
  1254.            ___________________________        _______________________
  1255.  
  1256.            Searchlight BBS                    HS-SLBBS.ZIP
  1257.            Spitfire BBS version 3.0           HS-SF30.ZIP
  1258.            UltraBBS version 2.08              HS-UB208.ZIP
  1259.            Wildcat! Test Drive v. 2.15        HS-WC215.ZIP
  1260.  
  1261.            Auntie 5.12                        HS-AU512.ZIP
  1262.            GAP 5.1                            HS-GAP51.ZIP
  1263.            MarkMail under Gap                 HS-MKML.ZIP
  1264.            PCBOARD 14.5  (11/90)              HS-145.ZIP
  1265.            PCBOARD 14.5a (10/30/91)           HS-145A.ZIP
  1266.            PROBOARD 1.17                      HS-PB117.ZIP
  1267.            PRODOOR 3.43 (10/30/91)            HS-PROD.ZIP
  1268.            RemoteAccess 1.10                  HS-RA110.ZIP
  1269.            RemoteAccess 1.11                  HS-RA111.ZIP
  1270.            RemoteAccess                       HS-RA.ZIP
  1271.            RBBS 17.3C (12/05/91)              HS-R173C.ZIP
  1272.            Rybbs                              HS-RYBBS.ZIP
  1273.            SuperBBS 1.15 Gamma4               HS-S1154.ZIP
  1274.            Searchlight BBS                    HS-SLBBS.ZIP
  1275.            Spitfire BBS version 3.0           HS-SF30.ZIP
  1276.            UltraBBS version 2.08              HS-UB208.ZIP
  1277.            Virtual BBS version 5.40           HS-VBB54.ZIP
  1278.            Waffle                             HS-WAF.ZIP
  1279.            Wildcat! Test Drive version 2.15   HS-WC215.ZIP
  1280.            WWIV version 4.20                  HS-WWIV.ZIP
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.       HS/Link 1.1 User Documentation                                    - 22 - 
  1300.  
  1301.  
  1302.  
  1303.  
  1304.                                    BBS Requirements
  1305.           _________________________________________________________________
  1306.  
  1307.       HS/Link's demands on a bulletin board program are extremely easy to fill. 
  1308.       The following is all that is necessary:
  1309.  
  1310.       1)   The protocol accepts either a
  1311.            filename to download or a list of    ┌────────────────────────┐
  1312.            files of the form                    │Send file lists are text│
  1313.            @DRIVE:\PATH\DOWNLIST.LST.  The      │files that contain one  │
  1314.            protocol will send only the          │path/filename per line. │
  1315.            specified files if filenames         └────────────────────────┘
  1316.            (without leading @) are given, or
  1317.            all of the files found in
  1318.            C:\BBS\DOWNLIST.LST if @C:\BBS\DOWNLIST.LST is specified.
  1319.  
  1320.       2)   The protocol will create a DSZLOG compatible log file indicating the
  1321.            names of all files transferred as well as their status (refer to the
  1322.            DSZ standard and the "DSZLOG Statistic Logging" section for the
  1323.            specific contents of the file).
  1324.  
  1325.       3)   Any files found in the DSZLOG file
  1326.            which BBS did not tell the protocol  ┌─────────────────────────┐
  1327.            to SEND are assumed to have instead  │HS/Link does NOT modify  │
  1328.            been RECEIVED by the protocol.  The  │BBS upload listings!     │
  1329.            BBS should then check for the        │The BBS program must     │
  1330.            existence of such files and if       │detect uploads and do    │
  1331.            found, ask for descriptions and      │it's own file management.│
  1332.            post them in the upload directory.   └─────────────────────────┘
  1333.  
  1334.  
  1335.       If the BBS program is not yet able to
  1336.       cope with bidirectional uploads, the -NU  ┌──────────────────────┐
  1337.       option can be used on the 'download'      │Use -NU to block all  │
  1338.       command line to prevent attempts to       │bidirectional uploads.│
  1339.       perform a bidirectional upload.           └──────────────────────┘
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.       HS/Link 1.1 User Documentation                                    - 23 - 
  1359.  
  1360.  
  1361.  
  1362.  
  1363.                                      Flow Control
  1364.           _________________________________________________________________
  1365.  
  1366.       Flow Control is required when the sending and receiving computers or
  1367.       modems operate at different speeds, or when computers are unable to
  1368.       simultaneously access disk drives and the COM port.  Flow Control is a
  1369.       software and/or hardware means of slowing down the faster parts of the
  1370.       connection to prevent overloading the slower parts of the system.
  1371.  
  1372.       HS/Link uses both XON/XOFF (software) and RTS/CTS (hardware) handshake
  1373.       when communicating with high speed modems or slow packet switched
  1374.       networks.  The protocol also uses a window algorithm to suspend data
  1375.       transmission if the receiver does not eventually respond to transmitted
  1376.       data.
  1377.  
  1378.       XON/XOFF handshake is a software handshake scheme that should work well
  1379.       on all combinations of modems and networks, and is enabled by default. 
  1380.       If you prefer not to use XON/XOFF handshake, or you find that it is not
  1381.       required for error-free transfer, you can disable it with the -HX option. 
  1382.       Note that both the sender and the receiver must simultaneously disable
  1383.       XON/XOFF handshake, otherwise it will remain in effect.
  1384.  
  1385.       The slow handshake option (-HS) is available for systems with slow disk
  1386.       access.  Use this if you get frequent CRC errors or COM Overrun errors on
  1387.       otherwise clean lines.  The slow handshake option causes XOFF to be sent
  1388.       and/or RTS to be lowered during any disk
  1389.       activity.  Even when -HS is active, the   ┌───────────────────────────┐
  1390.       HS/Link protocol should transfer data     │The -HS option stops most  │
  1391.       very nearly as fast as the slowest part   │Overrun and CRC errors that│
  1392.       of the link allows.                       │occur during or immediately│
  1393.                                                 │after disk I/O takes place.│
  1394.       CTS transmitter handshake is              └───────────────────────────┘
  1395.       automatically enabled, but may conflict
  1396.       with some unusual modem cables or serial ports.  If the CTS signal is not
  1397.       active when HSLINK loads, it will automatically disable CTS handshake for
  1398.       you.  Use the -HC command to manually disable CTS handshake.
  1399.  
  1400.       RTS receiver handshake is used when the slow-handshake option is
  1401.       selected.  This form of handshake causes the RTS line to the modem to be
  1402.       lowered whenever the disk is being accessed.  Some unusual modem or cable
  1403.       arrangements may not tolerate the RTS line being lowered.  In this case,
  1404.       the RTS handshake can be disabled with the -HR option.
  1405.  
  1406.       If you have frequent CRC errors or COM Overrun errors, which persist in
  1407.       spite of the handshake-slow option (-HS), you should consider upgrading
  1408.       your serial port from the usual 8250 to a newer, buffered NS16550AN chip. 
  1409.       The buffered chips are highly recommended if you are operating at high
  1410.       baud rates (>9600) or are accessing extended memory or are multi-tasking.
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.       HS/Link 1.1 User Documentation                                    - 24 - 
  1418.  
  1419.  
  1420.  
  1421.  
  1422.       I have also had reports that use of large numbers of dos BUFFERS in
  1423.       CONFIG.SYS can cause overrun errors.  Try reducing the BUFFERS setting to
  1424.       10 or less, especially if you also use a DISK cache.
  1425.  
  1426.       Some disk cache programs have also been reported to cause overrun errors. 
  1427.       Try turning the cache OFF before calling HSLINK, and turning it back ON
  1428.       again after the transfer is completed.
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.                                  Buffered ASYNC chips
  1435.           _________________________________________________________________
  1436.  
  1437.       The National NS16550AN is a pin compatible plug in replacement for 8250
  1438.       and 16450 serial chips.  It contains hardware buffering to allow faster
  1439.       operation in systems with high interrupt service latency.
  1440.  
  1441.       If you have an NS16550AN buffered UART
  1442.       chip, HS/Link will automatically enable   ┌───────────────────────────┐
  1443.       buffering for better performance with     │The NS16550AN chip stops   │
  1444.       high speed modems and multi-tasking       │most Overrun and CRC errors│
  1445.       environments.                             │encountered with COM port  │
  1446.                                                 │opening speeds of 9600 and │
  1447.       The -N5 option may be needed with some    │higher.                    │
  1448.       early versions, or incorrect clone        └───────────────────────────┘
  1449.       versions of the NS16550 chip, which do
  1450.       not properly perform buffering.
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.       HS/Link 1.1 User Documentation                                    - 25 - 
  1477.  
  1478.  
  1479.  
  1480.  
  1481.                            Full Streaming Data Transmission
  1482.           _________________________________________________________________
  1483.  
  1484.       The HS/Link protocol allows multiple data blocks to be transmitted before
  1485.       an acknowledgement is required by use of block numbers combined with a
  1486.       window algorithm.
  1487.  
  1488.       The protocol also allows acknowledgements to be combined with data
  1489.       flowing in the opposite direction, making it possible to achieve full
  1490.       streaming simultaneously in both directions over a full duplex
  1491.       communication link.
  1492.  
  1493.       Even though the transmitters operate in full streaming mode, the
  1494.       receivers normally will periodically acknowledge that data is being
  1495.       received.  This acknowledgement can be disabled with the -A option.
  1496.  
  1497.       Recent advances in high speed modem technology have made it possible to
  1498.       simultaneously transfer data at high      ┌───────────────────────────┐
  1499.       speeds in both directions.  This          │The HST modem is not well  │
  1500.       standardized technology is called "V.32"  │suited for bidirectional   │
  1501.       or "V.32bis", and are available in many   │transfers.  Switch to V.32 │
  1502.       new modems.  The bidirectional            │modes, if available, for   │
  1503.       capabilities of HS/Link take full         │higher thru-put.           │
  1504.       advantage of these modems, cutting        └───────────────────────────┘
  1505.       online time as much as 50% when equal
  1506.       amounts of data are transmitted and received.
  1507.  
  1508.       Some older high speed modems, such as the HST and Hayes-V, do not
  1509.       implement V.32 and are able to transfer quickly in only one direction,
  1510.       while the other direction is relatively slow.  HS/Link will still perform
  1511.       well as a single direction protocol with these modems, but bidirectional
  1512.       thruput will be low due to the "ping
  1513.       pong" effect of the modem switching the   ┌────────────────────────┐
  1514.       high speed channel back and forth.        │The "Ping Pong" effect  │
  1515.                                                 │slows bidirectional     │
  1516.                                                 │transfers on older 9600 │
  1517.                                                 │baud modems.            │
  1518.                                                 └────────────────────────┘
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.       HS/Link 1.1 User Documentation                                    - 26 - 
  1536.  
  1537.  
  1538.  
  1539.  
  1540.                             Full Streaming Error Recovery
  1541.           _________________________________________________________________
  1542.  
  1543.       The HS/Link protocol has the unique ability to recover from many
  1544.       transmission errors without breaking out of full streaming mode.
  1545.  
  1546.       This is important with buffered modems or packet switched networks with
  1547.       long turnaround times.
  1548.  
  1549.       Conventional protocols, such as Zmodem, simply reposition the transmitter
  1550.       after an error, requiring a retransmission of not only the erroneous
  1551.       data, but also the entire stream of data that was in transit at the time
  1552.       the error was detected.
  1553.  
  1554.       The HS protocol can correct bad blocks
  1555.       without retransmitting intermixed good    ┌───────────────────────────┐
  1556.       blocks, resulting in excellent transfer   │Full-Streaming-Error-      │
  1557.       speeds under moderate line noise          │Correction cannot stop flow│
  1558.       conditions.                               │control failure-related    │
  1559.                                                 │errors.  See the section   │
  1560.                                                 │on Flow Control if you have│
  1561.                                                 │persistent errors.         │
  1562.                                                 └───────────────────────────┘
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.       HS/Link 1.1 User Documentation                                    - 27 - 
  1595.  
  1596.  
  1597.  
  1598.  
  1599.                               Dynamic Code Substitution
  1600.           _________________________________________________________________
  1601.  
  1602.       Certain byte codes cannot be transmitted directly over the COM link.  For
  1603.       instance, the codes for Control-X, Control-S and Control-Q must be
  1604.       "escaped" to prevent a conflict with flow or program control.
  1605.  
  1606.       The HS/Link protocol uses a new Dynamic Code Substitution system to
  1607.       drastically reduce number protocol overhead and "escape" codes needed to
  1608.       transmit certain data streams.
  1609.  
  1610.       Highly compressed data files (such as ZIP and GIF files) benefit the
  1611.       most, since they often have many byte codes that cannot be transmitted
  1612.       directly over the COM link.
  1613.  
  1614.       The Dynamic Code Substitution feature can be disabled, if you wish, with
  1615.       the -NC option.
  1616.  
  1617.  
  1618.  
  1619.  
  1620.                             Transmission of Minimal Blocks
  1621.           _________________________________________________________________
  1622.  
  1623.       The HS/Link protocol includes a Minimal
  1624.       Blocks feature, which when activated,     ┌───────────────────────────┐
  1625.       causes the protocol to strip away         │Enable Minimal-Blocks with │
  1626.       repeated information from the protocol    │the -NM option only if you │
  1627.       frames and transmit only the minimal      │are operating with an error│
  1628.       amount of information required for data   │free link.                 │
  1629.       flow.                                     └───────────────────────────┘
  1630.  
  1631.       This feature results in a savings of over 50% of the normal protocol
  1632.       overhead characters in each block of data, while retaining full data
  1633.       integrity.  All data and control blocks are fully protected by a 32 bit
  1634.       CRC calculation, even when Minimal Blocks is in effect.
  1635.  
  1636.       The final block in a file rarely ends on an exact transfer block
  1637.       boundary.  The HS/Link protocol automatically shortens the final block,
  1638.       eliminating extraneous data transmission at the end of file.
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.       HS/Link 1.1 User Documentation                                    - 28 - 
  1654.  
  1655.  
  1656.  
  1657.  
  1658.                                DSZLOG Statistic Logging
  1659.           _________________________________________________________________
  1660.  
  1661.       When you define the environment variable DSZLOG, the HSLINK program will
  1662.       enable transfer logging to the specified filename.  The log file can also
  1663.       be set with the -FL option.  For example, the AUTOEXEC statement:
  1664.            SET DSZLOG=C:\LOGS\LOG.OUT
  1665.       will cause HSLINK to log files transmitted to C:\LOGS\LOG.OUT.  This form
  1666.       of logging provides compatibility with programs that are designed to
  1667.       operate with DSZ or other DSZLOG-type protocols.
  1668.  
  1669.       The log file consists of a single line of text for each file transferred. 
  1670.       Here are some sample log entries:
  1671.  
  1672.  h 227596 10100 bps 1138 cps   0 errors   112 2316 V:\UPLOAD\ZLABP_13.ZIP 0
  1673.  H 177901 10100 bps 1116 cps   1 errors     0  749 U:\PLAY1\ECOMM22.ZIP 0
  1674.  h  16155 10100 bps 1061 cps   0 errors     4  795 W:\ULW\WINROACH.ZIP 0
  1675.  L 136991 10100 bps    0 cps   0 errors    55 1823 W:\ULW\WINDE223.ZIP 11
  1676.  E 152614 10100 bps    0 cps  14 errors    22   38 W:\ULW\CLPGR21C.ZIP 0 2
  1677.  
  1678.       Each line contains the following fields:
  1679.  
  1680.       Size      Description
  1681.       ----      -------------------------------------------
  1682.       1         'H'=file received from remote
  1683.                 'h'=file sent to remote
  1684.                 'E'=file receive was aborted
  1685.                 'e'=file transmit was aborted
  1686.                 'L'=lost carrier during file receive
  1687.                 'l'=lost carrier during file transmit
  1688.  
  1689.       7         The length of the file, in bytes.   If the transfer was
  1690.                 aborted, this field will contain the number of bytes
  1691.                 transferred before the transfer was aborted.
  1692.  
  1693.       6         The effective modem-to-modem connect speed.
  1694.       4         Literally ' bps'
  1695.  
  1696.       5         The average transfer rate, in characters per second.
  1697.       4         Literally ' cps'
  1698.  
  1699.       4         The total number of blocks which required retransmission during
  1700.                 the transfer.
  1701.       7         Literally ' errors'
  1702.  
  1703.       6         The number of flow control restrictions.
  1704.       5         The length of the last block transferred in the file.
  1705.       ?         The full pathname of the file which was transferred.
  1706.       ?         The Serial Number of the remote HSLINK, if registered. 
  1707.                 Otherwise 0.
  1708.  
  1709.  
  1710.  
  1711.  
  1712.       HS/Link 1.1 User Documentation                                    - 29 - 
  1713.  
  1714.  
  1715.  
  1716.  
  1717.                                 Network Compatibility
  1718.           _________________________________________________________________
  1719.  
  1720.       All file processing is fully network and
  1721.       "share" compatible.  HSLINK can be        ┌────────────────────────┐
  1722.       easily installed in multi-user or         │HS/Link automatically   │
  1723.       networked computers.  This works with     │enables file sharing in │
  1724.       DOS version 3.0 and later.                │network environments.   │
  1725.                                                 └────────────────────────┘
  1726.  
  1727.       When transmitting a file, the file is opened in "allow read, deny none"
  1728.       mode.
  1729.  
  1730.       When receiving a file, the newly created file is created in "allow read,
  1731.       allow write, deny all" mode, which prevents other programs from altering
  1732.       the file which is being created.
  1733.  
  1734.       If a file sharing violation is detected when opening a file, the program
  1735.       passes control to the system's current "critical error" handler.  To
  1736.       automate recovery from file sharing violations, you should consider
  1737.       installing my FATAL14.ZIP program, which will automatically retry after
  1738.       sharing violations, and which will keep a detailed log of all critical
  1739.       errors in a system since the time the program was loaded into memory.
  1740.  
  1741.       All files transmitted or received with HS/Link retain their original
  1742.       exact size and time/date stamp.  No extraneous data is added beyond EOF
  1743.       as with some older protocols.  The current date/time will be stamped on
  1744.       incoming files if the -NT option is used.  Otherwise, the original file's
  1745.       time/date stamp will be retained.
  1746.  
  1747.       When run under DOS 2.x, HSLINK automatically reverts to non-share file
  1748.       modes.
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.       HS/Link 1.1 User Documentation                                    - 30 - 
  1772.  
  1773.  
  1774.  
  1775.  
  1776.                                    Auto Downloading
  1777.           _________________________________________________________________
  1778.  
  1779.       It is possible for some terminal
  1780.       programs to support HS/Link auto          ┌───────────────────────────┐
  1781.       downloading by means of "scripts" which   │With HS/Link Auto-Download │
  1782.       wait for the HS/Link "ready" packet, and  │You don't have to hit any  │
  1783.       then shell out to the HSLINK receiver     │additional keys to execute │
  1784.       protocol.                                 │the HSLINK driver.         │
  1785.                                                 └───────────────────────────┘
  1786.  
  1787.       This capability is currently active when HS/Link is installed in {COMMO}
  1788.       and BOYAN 5.0, any may be available soon under many other terminal
  1789.       programs as the respective authors add the capability to recognize
  1790.       external protocol signon signatures.
  1791.  
  1792.  
  1793.       The HS/Link "ready" packet is repeated at 10 second intervals when
  1794.       waiting for the HSLINK receiver to be started.  The format of the "ready"
  1795.       packet is:
  1796.  
  1797.            "HS*" ^B "R"
  1798.       or in hex,
  1799.            0x02 0x52
  1800.  
  1801.       When this sequence of characters is received during a terminal 
  1802.       session, the HSLINK protocol should be executed.
  1803.  
  1804.  
  1805.       The HSLINK program sends a different "ready" packet when no files need to
  1806.       be sent, but upload files are expected from the remote system.  This
  1807.       "ready" packet signature can be used to implement HS/Link Automatic
  1808.       Upload.  The format of the "upload ready" packet is:
  1809.  
  1810.            "HS*" ^B "Q"
  1811.       or in hex,
  1812.            0x02 0x51
  1813.  
  1814.       When this sequence of characters is received during a terminal session,
  1815.       an HS/Link upload should be started.   The three character prefix "HS*"
  1816.       was added with version 1.1 and is needed only if the shorter 2 character
  1817.       signatures are being used for another purpose.
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.       HS/Link 1.1 User Documentation                                    - 31 - 
  1831.  
  1832.  
  1833.  
  1834.  
  1835.                                     Error Messages
  1836.           _________________________________________________________________
  1837.  
  1838.       Bad ____ CRC
  1839.            These messages indicate that an error was detected in a control
  1840.            message between the sender and the receiver.  All control packets
  1841.            are protected by a 32 bit CRC calculation to provide highly secure
  1842.            and reliable communication.
  1843.  
  1844.            If you repeatedly receive the "Bad ready packet CRC" message, it may
  1845.            indicate that the internal protocol formats have been changed and
  1846.            that you need to upgrade to a newer beta copy of HSLINK.
  1847.  
  1848.       Bad data CRC (#)
  1849.       Dropped bytes -# (#)
  1850.       Noise burst # (#)
  1851.            These messages indicate that an error was detected in a block of
  1852.            data in the file being received.  "Dropped bytes" indicates that
  1853.            some expected bytes did not arrive, and "Noise burst" indicates that
  1854.            more bytes than expected arrived.  Error correction is automatic,
  1855.            because of Full-Streaming-Error-Correction, may occur without
  1856.            breaking the stream of data being received.
  1857.  
  1858.            If this message occurs at regular intervals, it is a sign of flow
  1859.            control failure.  In most cases, this can be corrected with the
  1860.            addition of the -HS command line option.
  1861.  
  1862.       COM#: Break!
  1863.       COM#: Framing!
  1864.       COM#: Overrun!
  1865.       COM#: Parity!
  1866.            These messages indicate that an error was detected in the serial
  1867.            port receiver.  Framing and Parity errors often indicate a baud rate
  1868.            mismatch.  Overrun errors usually indicate the need for flow control
  1869.            or for an upgrade to a buffered serial chip.  Overrun errors can
  1870.            often be reduced or eliminated with the use of the -HS command line
  1871.            option.
  1872.  
  1873.       Can't create file '___'
  1874.            This indicates that the received file could not be created.  This
  1875.            usually indicates that the directory specified in the -U command
  1876.            line option is invalid, or that the disk is full.
  1877.  
  1878.       Carrier lost!
  1879.            This indicates that Carrier detect was dropped, aborting the HSLINK
  1880.            session.  If your connection does not provide a carrier detect
  1881.            signal, you can disable this check with the -C command line option. 
  1882.            This is often required when directly connecting two computers by
  1883.            means of a "null modem" cable.
  1884.  
  1885.       Control-X abort!
  1886.            This indicates that the control-x character was received twice in
  1887.            succession, either over the COM port or from the local keyboard.
  1888.  
  1889.       HS/Link 1.1 User Documentation                                    - 32 - 
  1890.  
  1891.  
  1892.  
  1893.  
  1894.       Disk write failure!  (#)
  1895.            This usually indicates that the disk is full and that further
  1896.            downloads cannot be received.
  1897.  
  1898.       Flow control released (#### t:# r:#)
  1899.            If output flow has been suspended by either software or hardware
  1900.            flow control for more than 15 seconds, the program will assume that
  1901.            there has been a failure of flow control and will release the hold
  1902.            so data can continue.  The codes in parenthesis indicate which flow
  1903.            controls were active at the time (C=CTS was down, T=transmitter XOFF
  1904.            was pending, R=receiver XOFF was pending, A=transmitter is currently
  1905.            active) and the counts of bytes in the transmit and receive holding
  1906.            queues.
  1907.  
  1908.       FILE was incomplete!  (# #)
  1909.            This message indicates that the transfer was aborted in some way
  1910.            before the specified file was completely received.  Normally
  1911.            incomplete files are erased from disk, but they will be retained of
  1912.            the -K command line option is used.
  1913.  
  1914.       Not allowed to overwrite existing file '___'
  1915.            This indicates that a file was received but there was another file
  1916.            with the same name already in the download file directory.  Either
  1917.            erase the duplicate file, or use the -O option to allow existing
  1918.            files to be overwritten.
  1919.  
  1920.       Insufficient memory to load program.
  1921.       Not enough memory!
  1922.            There was not enough memory available to run HSLINK.  Free
  1923.            additional memory by removing "TSR" software, device drivers,
  1924.            ramdisks or disk caches.  If your COMM program has the option of
  1925.            swapping to DISK or EMS, enable the option to free additional memory
  1926.            for HSLINK's use.  Current beta copies of HSLINK require about 64k
  1927.            of RAM, but the specific amount of memory required is subject to
  1928.            change from beta to beta.  You can reduce the amount of memory
  1929.            required if you use the -NB command line option to disable file
  1930.            buffering.
  1931.  
  1932.       Read failure at #
  1933.            This indicates that there was a disk error reading a file being
  1934.            transmitted.
  1935.  
  1936.       Remote not responding!
  1937.            This indicates that the remote computer did not execute HSLINK and
  1938.            establish a connection within the two minute timeout period.
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.       HS/Link 1.1 User Documentation                                    - 33 - 
  1949.  
  1950.  
  1951.  
  1952.  
  1953.                                  Information Messages
  1954.           _________________________________________________________________
  1955.  
  1956.       Receive timeout (#)
  1957.       ACK timeout, resend #
  1958.            This message indicates that it has been too long since the receiver
  1959.            responded to data transmission.  The last data block is repeated in
  1960.            an attempt to wake up the receiver.
  1961.  
  1962.       Block size: #
  1963.            This message indicates the actual block size being used for file
  1964.            transfers.  The block size is controlled by the -W parameter, and
  1965.            may be overridden by the remote computer if the remote uses the -! 
  1966.            (take priority) option.
  1967.  
  1968.       COM#: # bps
  1969.            This message indicates the actual COM port speed in use, either as
  1970.            specified with the -B command line option, or as determined from the
  1971.            current hardware settings.
  1972.  
  1973.       HS/Link finished! (t:# r:#) Exit code = #
  1974.            When HSLINK terminates, it sets the dos ERRORLEVEL to the specified
  1975.            value.  This can be checked in batch files to detect error
  1976.            conditions.  Under normal conditions, HSLINK exits with an
  1977.            ERRORLEVEL of 0.  If, however, the session terminated due to errors,
  1978.            or was aborted by the operator, the ERRORLEVEL will be non-0.  The
  1979.            following ERRORLEVEL codes are possible:
  1980.  
  1981.            ERRORLEVEL          Reason for link termination
  1982.            ----------          ----------------------------------------
  1983.  
  1984.               0           One or more files transferred successfully
  1985.               1           ^X typed at local keyboard
  1986.               2           ^X received over COM port
  1987.               3           Incompatible BETA versions
  1988.               4           No files transmitted or received
  1989.               5           Remote did not respond within 2 minutes
  1990.               6           Too many framing errors, possible -B mismatch
  1991.               7           Possible tampering or corruption in HSLINK.EXE
  1992.               8           Possible tampering or corruption in HSLINK.EXE
  1993.               9           COM port not responding, incorrect -P options
  1994.              10           Carrier lost during initial handshake with remote
  1995.              11           Link aborted due to CTS lockup
  1996.  
  1997.            COMM and BBS programs should use the DSZLOG output file to determine
  1998.            more specific details of transfer results.  
  1999.  
  2000.            The (t:# r:#) display indicates the number of files successfully
  2001.            transmitted and received.
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.       HS/Link 1.1 User Documentation                                    - 34 - 
  2008.  
  2009.  
  2010.  
  2011.  
  2012.       File received OK, # cps, # seconds.
  2013.            The file was received correctly and is now closed.  The average
  2014.            transfer speed is calculated based on the elapsed time between
  2015.            receiving the file open packet and the last byte of the file. 
  2016.            Transfer speeds are calculated using the DOS timer tick, which is
  2017.            not accurate for transfers taking less than 1 second to complete. 
  2018.            For very short transfers, a cps rating of 9999 will be returned.
  2019.  
  2020.       File sent OK, # cps, # seconds.
  2021.            The file was transmitted correctly and is now closed.  The average
  2022.            transfer speed is calculated based on the elapsed time between
  2023.            sending the first byte of the file and the last byte of the file. 
  2024.            Transfer speeds are calculated using the DOS timer tick, which is
  2025.            not accurate for transfers taking less than 1 second to complete. 
  2026.            For very short transfers, a cps rating of 9999 will be returned.
  2027.  
  2028.       File skipped!
  2029.            The transmitter prints this message when the receiver requests the
  2030.            current file be skipped.  This usually happens when the receiver
  2031.            detects a duplicate filename and is not allowed to overwrite
  2032.            existing files.
  2033.  
  2034.       Handshake: CTS XON/XOFF SLOW
  2035.            This message indicates the current combination of flow control
  2036.            options that are in effect.  CTS indicates CTS hardware flow control
  2037.            is active.  XON/XOFF indicates that XON/XOFF software flow control
  2038.            is active.  SLOW indicates that flow will be restrained during disk
  2039.            I/O to prevent overrun errors.
  2040.  
  2041.       Out of sequence # (#)
  2042.            This indicates that the received block was out of sequence,
  2043.            indicating that a block was possibly missed or lost during
  2044.            transmission.  The receiver will request the transmitter to
  2045.            retransmit the missing block(s).
  2046.  
  2047.       Received block # (# bytes) # cps
  2048.            This displays the current status of the file being received.  The
  2049.            current number of blocks and bytes received is displayed after each
  2050.            block is received.  The estimated transfer speed in ch/sec is also
  2051.            displayed.
  2052.  
  2053.       Received block # (# bytes) E#
  2054.            When "E#" is displayed following the received block # message, it
  2055.            indicates that error recovery is in progress, and that the specified
  2056.            block number was in error and is in transit from the transmitter. 
  2057.            When the erroneous block has been received correctly the E# display
  2058.            will advance to the next erroneous block number, or will be erased
  2059.            if no more erroneous blocks are pending.
  2060.       Received block # (# bytes) R
  2061.            When "R" is displayed following the received block # message, it
  2062.            indicates that current block has been previously received correctly
  2063.            and is therefore a "repeat" block.  Repeat blocks occur under severe
  2064.            error conditions and are usually corrected automatically.
  2065.  
  2066.       HS/Link 1.1 User Documentation                                    - 35 - 
  2067.  
  2068.  
  2069.  
  2070.  
  2071.       Receiving file: ___ (# blocks, # bytes)
  2072.            This message indicates that a new file is being received from the
  2073.            transmitter.  The file size is displayed in blocks and bytes.
  2074.  
  2075.       Resending block #
  2076.            This message indicates that the receiver has detected an erroneous
  2077.            block and is requesting a retransmission to correct the data.  Data
  2078.            flow continues where it left off prior to the resend, allowing error
  2079.            recovery to take place without breaking out of full streaming mode
  2080.            and without discarding data that is already in transit to the
  2081.            receiver.  This is the basis of Full- Streaming-Error-Correction.
  2082.  
  2083.       Restarting current file
  2084.            This indicates that the receiver was unable to recover from errors
  2085.            encountered in processing the current file being transmitted, and
  2086.            has requested that the file be started again from scratch.
  2087.  
  2088.       Seek from block # to #
  2089.            Under the most severe error conditions, the receiver may request the
  2090.            transmitter to discard data that is in transit to the receiver and
  2091.            to rewind to an earlier position in the file and resume
  2092.            transmission.
  2093.  
  2094.       Sending block # (# bytes/w:#) # cps
  2095.            This is the normal status display while a file is being transmitted. 
  2096.            The message indicates the latest block number to be transmitted, and
  2097.            in parenthesis indicates the number of bytes transmitted and the
  2098.            current number of blocks that have been transmitted without
  2099.            acknowledgement, which represents the size of the transmit "window"
  2100.            that is currently in use.  If this value hangs at the current -W
  2101.            setting, you may benefit from a higher -W setting on the command
  2102.            line.  The estimated transfer speed is also reported in ch/sec.
  2103.  
  2104.       Sending file: ___ (# blocks, # bytes)
  2105.            This message indicates that a new file is being transmitted to the
  2106.            receiver.  The file size is displayed in blocks and bytes.
  2107.  
  2108.       Transfer aborted!
  2109.            This message indicates that the current file transfer has been
  2110.            aborted for some reason.  The specific reason for the transfer abort
  2111.            is usually also printed on the screen.
  2112.  
  2113.       Waiting for remote.
  2114.            This message indicates that HSLINK is waiting to handshake with the
  2115.            remote computer.  HSLINK will wait for 60 seconds for the other
  2116.            computer to come online; after that the transfer is aborted.
  2117.  
  2118.       Warning: CTS signal missing!  -HC will be assumed.
  2119.            The CTS hardware handshake is normally enabled by default.  If, on
  2120.            initial loading, HSLINK finds that the CTS signal is down, it
  2121.            assumes that the current hardware configuration is not using CTS
  2122.            handshake and automatically disables further CTS handshake checks. 
  2123.            Use the -HC command line to manually disable CTS handshake.
  2124.  
  2125.       HS/Link 1.1 User Documentation                                    - 36 - 
  2126.  
  2127.  
  2128.  
  2129.  
  2130.       Window: #
  2131.            This indicates the actual number of blocks that are allowed to be in
  2132.            transit without acknowledgement.  This is controlled by the -W
  2133.            parameter, and may be overridden by the remote computer if the
  2134.            remote uses the -!  (take priority) option.
  2135.  
  2136.       Window: NONE
  2137.            This indicates that the -A command line option has been specified,
  2138.            and that the transmitter is required to continue indefinitely
  2139.            without receiving any kind of acknowledgement from the receiver that
  2140.            data is being received correctly.
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.       HS/Link 1.1 User Documentation                                    - 37 - 
  2185.  
  2186.  
  2187.  
  2188.  
  2189.                                License and Registration
  2190.           _________________________________________________________________
  2191.  
  2192.       This program is not free!  You are hereby licensed to use this program
  2193.       for a trial period of 30 days free of charge.  If, after 30 days, you
  2194.       decide that you would like to continue using HSLINK, you must complete
  2195.       the registration form (REGISTER.FRM) and return it to the author with the
  2196.       required registration fee enclosed.
  2197.  
  2198.       Registration removes the "UNREGISTERED" messages as well as all time
  2199.       delays.  Your registration number will be broadcast to the remote copy of
  2200.       hslink.
  2201.  
  2202.       Basic HSLINK registration costs $20 US, which includes a registration
  2203.       certificate showing a Serial Number and Password.  For $30 US, a disk
  2204.       containing the latest release of HSLINK, along with a registration
  2205.       certificate can be obtained.  Printed and bound operation manuals are
  2206.       also available for $15 each.  Each registration is valid for use on a
  2207.       single CPU or on a single BBS system (multi-node systems require only a
  2208.       single registration).
  2209.  
  2210.       Please feel free to distribute unregistered HSLINK to your friends and
  2211.       local BBSes as long as all of the files in this archive are included and
  2212.       unmodified.
  2213.  
  2214.  
  2215.       Send your registration payment to:
  2216.  
  2217.                           SAMUEL H.  SMITH
  2218.                           P. O. BOX 4808
  2219.                           PANORAMA CITY, CA 91412-4808
  2220.                           U.S.A.
  2221.  
  2222.       HS/Link registration can also be ordered ON LINE by credit card through
  2223.       any of the Tool Shop BBS phone lines.
  2224.  
  2225.  
  2226.  
  2227.                      LICENSE AGREEMENT FOR SHAREWARE DISTRIBUTORS
  2228.  
  2229.       Shareware distributors may distribute this program as long as the author
  2230.       has been notified, in writing, prior to ANY distribution.  The "per disk"
  2231.       charge may not exceed $6 and the shareware distributor will not change
  2232.       the above license fee for the end user of HSLINK.  End users are not
  2233.       exempt from registering HSLINK with the author at the normal registration
  2234.       fee.
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.       HS/Link 1.1 User Documentation                                    - 38 - 
  2244.  
  2245.  
  2246.  
  2247.  
  2248.                                        Support
  2249.           _________________________________________________________________
  2250.  
  2251.       HS/Link was Written by Samuel H. Smith.   Contact me at:
  2252.  
  2253.                           The Tool Shop BBS
  2254.  
  2255.       Phone number             Modem type
  2256.       --------------      --------------------------------------------
  2257.       (818) 891-6780      US Robotics 2400         (free line)
  2258.       (818) 891-3772      US Robotics HST 9600     ($20/yr subscription)
  2259.       (818) 891-1344      Supra v.32bis/v.42bis    ($20/yr subscription)
  2260.  
  2261.       You will always find the latest release version of HS/Link on the Tool
  2262.       Shop, as well as a variety of support files and programs.
  2263.  
  2264.       HS/Link is also supported by a number of authorized distributors
  2265.       throughout the world.  Please refer to DISTRIB.DOC for the latest
  2266.       distributor list.
  2267.  
  2268.       The HS/Link Support Conference is carried by UN'I-Net/US, SmartNet, RIME
  2269.       and possibly a number of other echo networks.  You can get direct product
  2270.       support through a local BBS that carries this echo conference.
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.                                       DISCLAIMER
  2279.  
  2280.            IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING
  2281.            ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR
  2282.            CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO
  2283.            USE THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.       HS/Link 1.1 User Documentation                                    - 39 - 
  2303.  
  2304.  
  2305.  
  2306.  
  2307.                                      Distributors
  2308.           _________________________________________________________________
  2309.  
  2310.  
  2311.       The following individuals are valid distributors as of 04/23/92.
  2312.  
  2313.  
  2314.       UNITED STATES
  2315.               William G. Poissant
  2316.               AMCOM
  2317.               5530 State Road
  2318.               Cleveland, Ohio 44134-2260
  2319.               (216) 398-1331 (voice)
  2320.               (216) 398-1330 (fax)
  2321.               (216) 526-9480 AMCOM BBS 2400 baud   (8 lines)
  2322.               (216) 526-9490 AMCOM BBS HST 14,400 v.32/V,32bis (3 lines)
  2323.               (216) 526-9096 AMCOM BBS HST/DS 14,400 v32/v32bis/v42/v42bis
  2324.  
  2325.       UNITED STATES
  2326.               Gene De Libero
  2327.               East Coast MIDI(tm) Information Systems
  2328.               21 September Street,
  2329.               Coram, New York 11727
  2330.               (516) 928-4284 (voice)
  2331.               (800) 736-0181 (voice - HS/Link orders ONLY!)
  2332.               (516) 928-4986 BBS HST 14,400/v42bis (multi-node)
  2333.  
  2334.       CANADA
  2335.               Daniel Coulombe
  2336.               Synapse BBS
  2337.               22 Beloeil,
  2338.               Gatineau, Quebec J8T 7G3
  2339.               (819) 561-1697 (VOICE)
  2340.               (819) 561-4321 (v.32)
  2341.               (819) 243-0306 (Hayes)
  2342.               (819) 561-0950 (HST)
  2343.  
  2344.       EUROPE - Netherlands
  2345.               Arthur A. Mol
  2346.               The Owl's Nest
  2347.               PO Box 227
  2348.               3760 AE Soest
  2349.               Netherlands
  2350.               +31-2155-26527 (FAX)
  2351.               +31-2155-12571 (BBS up to 14.4Kb HST/V32)
  2352.               +31-2155-26527 (BBS node 2 shared w/fax)
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.       HS/Link 1.1 User Documentation                                    - 40 - 
  2362.  
  2363.  
  2364.  
  2365.  
  2366.       EUROPE - Germany
  2367.               Frank Maroke
  2368.               BMS-Online / BMS-Systems GmbH
  2369.               Waldstrasse 5-7
  2370.               D(W)-6050 Offenbach/M. FRG/Germany
  2371.               ++49-69-881121 (BBS HST/DS)
  2372.               ++49-69-885042 (Voice)
  2373.  
  2374.       EUROPE - Switzerland
  2375.               Ernesto Guerber
  2376.               PRO - DOS
  2377.               Lenggenbachstr. 1
  2378.               8951 Fahrweid
  2379.               Switzerland
  2380.               +748-27-75 (BBS HST/DS)
  2381.               +748-33-32 (Voice)
  2382.               +748-27-75 (FAX)
  2383.  
  2384.       SOUTH AMERICA
  2385.               Horacio Stolovitzky
  2386.               SatLink Communications
  2387.               Casilla de Correo 3618
  2388.               (1000) Correo Central
  2389.               Buenos Aires - ARGENTINA
  2390.               For SOUTH AMERICA (Argentina, Chile, Brazil, Uruguay, Paraguay,   
  2391.                               Bolivia, Peru, Ecuador, Colombia and
  2392.                                  Venezuela)
  2393.               +54-1-52-1057 (BBS)
  2394.               +54-1-983-6740 (Voice)
  2395.               INTERNET: hslink@satlink.org.ar
  2396.  
  2397.       SINGAPORE
  2398.               Anthony Chin
  2399.               Artist On-Line Information System
  2400.               Blk 458, Ang Mo Kio, Avenue 10, #14-1584
  2401.               Singapore 2056
  2402.               Republic of Singapore
  2403.               +65-456-1100 (BBS HST/DS v.32bis)
  2404.  
  2405.       AUSTRALIA
  2406.               Peter Deegan
  2407.               My Computer Company BBS
  2408.               P.O. Box 99, Erskineville, NSW 2043
  2409.               Australia
  2410.               +61-2-565-1044 (BBS, v.32)
  2411.               +61-2-550-4459 (FAX)
  2412.               +61-2-565-1991 (Voice)
  2413.  
  2414.  
  2415.       If you experience any problems with a particular distributor, please
  2416.       contact me immediately so that we can get it resolved quickly.
  2417.  
  2418.  
  2419.  
  2420.       HS/Link 1.1 User Documentation                                    - 41 - 
  2421.  
  2422.  
  2423.  
  2424.  
  2425.                                         Index
  2426.           _________________________________________________________________
  2427.  
  2428.           Aborting a transfer . . . .  6          -B . . . . . . . . . . 10
  2429.           Auto-download . . . . . . . 31          -Bbaud . . . . . . . . 14
  2430.           Auto-Upload . . . . . . . . 31          -C . . . . . . . . 10, 14
  2431.           Basic settings  . . . . . .  9          -CB  . . . . . . . . . 13
  2432.           Configuration files                     -CBcolor . . . . . . . 14
  2433.                HSCONFIG . . . . . . .  7          -CG  . . . . . . . . . 13
  2434.                specifying alternate               -CGcolor . . . . . . . 14
  2435.                     configuration                 -CM  . . . . . . . . . 13
  2436.                     files . . . . . .  7          -CMcolor . . . . . . . 14
  2437.           Context sensitive help  . .  9          -CT  . . . . . . . . . 13
  2438.           Crash recovery                          -CTcolor . . . . . . . 14
  2439.                -K . . . . . . . . . . 11          -CW  . . . . . . . . . 13
  2440.                -O . . . . . . . . . . 11          -CWcolor . . . . . . . 14
  2441.                -R . . . . . . . . 11, 19          -E . . . . . . . . . . 10
  2442.           DesqView                                -Ebaud . . . . . . . . 15
  2443.                -I . . . . . . . . . . 12          -FC  . . . . . . . 12, 15
  2444.                -I2  . . . . . . . . . 16          -FL  . . . . . . . . . 12
  2445.                -NV  . . . . . . . . . 17          -HC  . . . . . . . 10, 15
  2446.           Display bleeding  . . . . .  5          -HR  . . . . . . . 10, 15
  2447.           Display colors  . . . . . . 13          -HS  . . . . . . 6, 9, 15
  2448.           Distributors  . . . . . . . 40          -HX  . . . . . . . 10, 15
  2449.           DoubleDOS                               -I . . . . . . . . . . 12
  2450.                -I3  . . . . . . . . . 16          -Iidle . . . . . . . . 16
  2451.                -NV  . . . . . . . . . 17          -K . . . . . . . . 11, 16
  2452.           DSZLOG  . . . . . . . . . . 29          -LFlogfile . . . . . . 16
  2453.           ERRORLEVEL  . . . . . . . . 34          -N5  . . . . . . . 12, 16
  2454.           Errors                                  -NB  . . . . . . . 11, 16
  2455.                -HS  . . . . . . . . .  6          -NC  . . . . . . . 11, 16
  2456.                COM Overrun  . . . 15, 24          -NF  . . . . .  5, 13, 16
  2457.                Error messages . . . . 32          -NM  . . . . . . . 12, 17
  2458.           Exit codes  . . . . . . . . 34          -NO  . . . . . . . . . 12
  2459.           File buffering  . . . . . . 11          -NOdirlist . . . . . . 17
  2460.           File sharing  . . . . . . . 30          -NT  . . . . . . . 10, 17
  2461.           Flow control  . . . . . . . 24          -NU  . . . . . . . . . 17
  2462.                -HC  . . . . . . . . . 10          -NV  . . . . .  5, 13, 17
  2463.                -HR  . . . . . . . . . 10          -O . . . . . . . . 11, 17
  2464.                -HS  . . . . . . . . .  6          -P . . . . . . . . . .  9
  2465.                -HX  . . . . . . . . . 10          -PBbase  . . . . . . . 18
  2466.           HSCONFIG  . . . . . . . . .  7          -PI  . . . . . . . . . 10
  2467.           HST . . . . . . . . . . . . 26          -PIirq . . . . . . . . 18
  2468.           Installation                            -Pport . . . . . .  6, 17
  2469.                In BBS programs  . . . 22          -R . . . . . . . . 11, 19
  2470.                In COMM programs . . . 21          -S . . . . . . . . . . 11
  2471.           Non-standard COM ports  10, 18          -Ssize . . . . . . . . 19
  2472.           NS16550AN . . . . . . . . . 25          -U . . . . . . . . . .  9
  2473.           Options . . . . . . . . . . 10          -Udir  . . . . . .  6, 19
  2474.                -! . . . . . . . . 11, 14          -W . . . . . . . . . . 11
  2475.                -@ . . . . . . . . . .  7          -Wwindow . . . . . . . 19
  2476.                -@fname  . . . . . . . 14     PC-Pursuit
  2477.                -A . . . . . . . . 11, 14          -W . . . . . . . . . . 19
  2478.  
  2479.       HS/Link 1.1 User Documentation                                    - 42 - 
  2480.  
  2481.  
  2482.  
  2483.  
  2484.                Example  . . . . . . . 20
  2485.           Registration  . . . . . 38, 40
  2486.           Support . . . . . . . . . . 39
  2487.           V.32  . . . . . . . . . . . 26
  2488.           Zmodem  . . . . . . . . . . 27
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526.  
  2527.  
  2528.  
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.       HS/Link 1.1 User Documentation                                    - 43 - 
  2539.